 /*******************************************************************************
  * Copyright (c) 2003, 2006 IBM Corporation and others.
  * All rights reserved. This program and the accompanying materials
  * are made available under the terms of the Eclipse Public License v1.0
  * which accompanies this distribution, and is available at
  * http://www.eclipse.org/legal/epl-v10.html
  *
  * Contributors:
  * IBM Corporation - initial API and implementation
  *******************************************************************************/
 package org.eclipse.ui.navigator;

 import org.eclipse.jface.viewers.ILabelProvider;

 /**
  *
  * Allows extensions to vary their behavior based on properties in the extension
  * model and the given memento.
  *
  * <p>
  * Clients should refer to the <b>org.eclipse.ui.navigator.navigatorContent</b>
  * extension point for more information on building a content extension.
  * </p>
  * <p>
  * Clients should not dispose of any Image Resources that might be shared by
  * other extensions when their Label Provider is disposed. When a content extension
  * is deactivated, both its content and label providers are disposed, but the
  * viewer remains visible to the user. If clients dispose of Image Resources used
  * by other extensions, then it will cause problems for those extensions and the
  * viewer in general.
  * </p>
  * <p>
  * Clients need not implement this interface if there is no cause to do so.
  * {@link org.eclipse.jface.viewers.ILabelProvider} is respected by the Common
  * Navigator.
  * </p>
  *
  *
  * @since 3.2
  */
 public interface ICommonLabelProvider extends ILabelProvider, IMementoAware,
         IDescriptionProvider {

     /**
      * Initialize the label provider with the given configuration.
      *
      * @param aConfig
      * The extension site provides information that some extensions
      * will find useful to configure themselves properly in a
      * particular viewer.
      *
      * @see ICommonContentProvider
      */
     void init(ICommonContentExtensionSite aConfig);

 }

